Developer Documentation

QuickTime 4 API Documentation

Inside Macintosh: Macintosh Toolbox Essentials

Previous | Chapter Top | Chapter Contents | Next |

Accessors for Low-Memory Globals

You should never access low-memory globals directly. Instead, use a high-level Window Manager function, if one is available. If a high-level function is not available, you can use one of the accessors described here.

LMSetAuxWinHead

Sets the handle used by the Window Manager to identify the first auxiliary window record in the auxiliary window list.

pascal void LMSetAuxWinHead (AuxWinHandle value);
value
A handle to the address you want to set for the first auxiliary window record in the auxiliary window list.

DESCRIPTION

The Window Manager creates and maintains the information in auxiliary window records. Your application seldom, if ever needs to access the auxiliary window list.

The LMSetAuxWinHead function sets the value of the low-memory global AuxWinHead , which contains a handle to the address interpreted by the Window Manager as the first auxiliary window record in the auxiliary window list.

SEE ALSO

For a description of the auxiliary window record, see "The Auxiliary Window Record" . To get a handle to an window's auxiliary window record, use the GetAuxWin function (GetAuxWin) . To get a handle to the first auxiliary window record in the auxiliary window list, use LMGetAuxWinHead (LMGetAuxWinHead) .

LMGetAuxWinHead

Gets the handle used by the Window Manager to identify the first auxiliary window record in the auxiliary window list.

pascal AuxWinHandle LMGetAuxWinHead (void);

DESCRIPTION

The Window Manager creates and maintains the information in auxiliary window records. Your application seldom, if ever needs to access the auxiliary window list.

The LMSetAuxWinHead function returns the value of the low-memory global AuxWinHead , which contains a handle to the address interpreted by the Window Manager as the first auxiliary window record in the auxiliary window list.

SEE ALSO

For a description of the auxiliary window record, see "The Auxiliary Window Record" . To get a handle to an window's auxiliary window record, use the GetAuxWin function (GetAuxWin) . To set a handle to the first auxiliary window record in the auxiliary window list, use LMSetAuxWinHead (LMSetAuxWinHead) .

LMSetDeskHook

Sets the procedure called by the Window Manager to paint the desktop.

pascal void LMSetDeskHook (UniversalProcPtr value);
value
A universal procedure pointer to the procedure you wish to set as the desk hook function.

DESCRIPTION

The LMSetDeskHook function sets the value of the low-memory global DeskHook , which contains a pointer to the procedure used by the Window Manager as the desk hook function.

SEE ALSO

To get the optional procedure that the Window Manager calls to paint the desktop, use the LMGetDeskHook function (LMGetDeskHook) .

LMGetDeskHook

Gets the optional procedure called by the Window Manager to paint the desktop.

pascal UniversalProcPtr LMGetDeskHook (void);

DESCRIPTION

The LMGetDeskHook function returns the value of the low-memory global DeskHook , which contains a pointer to the procedure used by the Window Manager as the desk hook function.

SEE ALSO

To set the optional procedure that the Window Manager calls to paint the desktop, use the LMSetDeskHook function (LMSetDeskHook) .

LMSetDragHook

Sets the optional procedure called by the Window Manager during TrackGoAway (TrackGoAway) , TrackBox (TrackBox) , DragWindow (DragWindow) , GrowWindow (GrowWindow) , and DragGrayRgn (DragGrayRgn) functions.

pascal void LMSetDragHook (UniversalProcPtr value);
value
A universal procedure pointer to the procedure you wish to set as the drag hook function.

DESCRIPTION

The LMSetDragHook function sets the value of the low-memory global DragHook , which contains a pointer to the procedure interpreted by the Window Manager as the drag hook function.

SEE ALSO

To get the optional drag hook procedure that the Window Manager calls, use the LMGetDragHook function (LMSetDeskHook) .

LMGetDragHook

Gets the optional procedure called by the Window Manager during TrackGoAway (TrackGoAway) , TrackBox (TrackBox) , DragWindow (DragWindow) , GrowWindow (GrowWindow) , and DragGrayRgn (DragGrayRgn) functions.

pascal UniversalProcPtr LMGetDragHook (void);

DESCRIPTION

The LMGetDragHook function returns the value of the low-memory global DragHook , which contains a pointer to the procedure used by the Window Manager as the drag hook function.

SEE ALSO

To set the optional drag hook procedure that the Window Manager calls, use the LMSetDragHook function (LMSetDragHook) .

LMSetDragPattern

Sets the pattern of the dragged region's outline.

pascal void LMSetDragPattern (const Pattern *dragPatternValue);
dragPatternValue
A pointer to the pattern you wish to set as the dragged pattern's outline.

DESCRIPTION

The LMSetDragPattern function sets the value of the low-memory global DragPattern .

SEE ALSO

To get the pattern of the dragged region's outline, use LMGetDragPattern (LMGetDragPattern) .

LMGetDragPattern

Gets the pattern of the dragged region's outline.

pascal void LMGetDragPattern (Pattern *dragPatternValue);
dragPatternValue
A pointer to the address at which the LMGetDragPattern function returns the pattern used by the Window Manager as the dragged pattern's outline.

DESCRIPTION

The LMSetDragPattern function gets the value of the low-memory global DragPattern .

SEE ALSO

To set the pattern of the dragged region's outline, use LMSetDragPattern (LMSetDragPattern) .

LMSetOldContent

Sets the handle used by the Window Manager to identify the saved content region.

pascal void LMSetOldContent (RgnHandle value);
value
A handle to the region you wish to set as the saved content region.

DESCRIPTION

The LMSetOldContent function sets the value of the low-memory global OldContent , which the Window Manager interprets as a handle to the saved content region.

SEE ALSO

To get the handle used by the Window Manager to identify the saved content region, use the LMGetOldContent function (LMGetOldContent) .

LMGetOldContent

Returns the handle used by the Window Manager to identify the saved content region.

pascal RgnHandle LMGetOldContent (void);

DESCRIPTION

The LMGetOldContent function returns the value of the low-memory global OldContent , which the Window Manager interprets as a handle to the saved content region.

SEE ALSO

To set handle used by the Window Manager to identify the saved content region, use LMSetOldContent (LMSetOldContent) .

LMSetOldStructure

Sets the handle used by the Window Manager to identify the saved structure region.

pascal void LMSetOldStructure (RgnHandle value);
value
A handle to the region you wish to set as the saved structure region.

DESCRIPTION

The LMSetOldStructure function sets the value of the low-memory global OldStructure , which the Window Manager interprets as a handle to the saved structure region.

SEE ALSO

To get handle used by the Window Manager to identify the saved structure region, use LMGetOldStructure (LMGetOldStructure) .

LMGetOldStructure

Sets the handle used by the Window Manager to identify the saved structure region.

pascal RgnHandle LMGetOldStructure (void);

DESCRIPTION

The LMGetOldStructure function returns the value of the low-memory global OldStructure , which the Window Manager interprets as a handle to the saved structure region.

SEE ALSO

To set handle used by the Window Manager to identify the saved content region, use LMSetOldStructure (LMSetOldStructure) .

LMSetPaintWhite

Sets the flag used by the Window Manager to determine whether to paint the window white before an update event.

pascal void LMSetPaintWhite (SInt16 value);
value
 

SEE ALSO

To get the flag used by the Window Manager to determine whether to paint the window white before an update event, use the LMGetPaintWhite function (LMGetPaintWhite) .

LMGetPaintWhite

Returns the flag used by the Window Manager to determine whether to paint the window white before an update event.

pascal SInt16 LMGetPaintWhite ( void );

SEE ALSO

To set the flag used by the Window Manager to determine whether to paint the window white before an update event, use the LMSetPaintWhite function (LMSetPaintWhite) .

LMSetSaveUpdate

Sets the flag used by the Window Manager to determine whether to generate update events.

pascal void LMSetSaveUpdate (SInt16 value);
value
 

SEE ALSO

To get the flag used by the Window Manager to determine whether to generate update events, use the LMGetSaveUpdate function (LMGetSaveUpdate) .

LMGetSaveUpdate

Returns the flag used by the Window Manager to determine whether to generate update events.

pascal SInt16 LMGetSaveUpdate (void);

DESCRIPTION

The LMGetSaveUpdate function sets the value of the low-memory global SaveUpdate , which the Window Manager uses to determine whether to generate update events.

SEE ALSO

To set the flag used by the Window Manager to determine whether to generate update event, use the LMSetSaveUpdate function (LMSetSaveUpdate) .

LMSetSaveVisRgn

Sets the handle used by the Window Manger to identify the saved visible region.

pascal void LMSetSaveVisRgn (RgnHandle value);
value
The region you want the Window Manager to interpret as the saved visible region.

DESCRIPTION

The LMSetSaveVisRgn function sets the value of the low-memory global SaveVisRgn , which the Window Manager interprets as a handle to the saved visible region.

SEE ALSO

To get the handle used by the Window Manager to identify the saved visible region, use the LMGetSaveVisRgn function (LMGetSaveVisRgn) .

LMGetSaveVisRgn

Returns the handle used by the Window Manger to identify the saved visible region.

pascal RgnHandle LMGetSaveVisRgn (void);

DESCRIPTION

The LMGetSaveVisRgn function returns the value of the low-memory global SaveVisRgn , which the Window Manager interprets as a handle to the saved visible region.

SEE ALSO

To set the handle used by the Window Manager to identify the saved visible region, use the LMSetSaveVisRgn function (LMSetSaveVisRgn) .

LMSetWindowList

Sets the pointer used by the Window Manager to identify the first window in the window list.

pascal void LMSetWindowList (WindowPtr value);
value
A pointer to the window you want to set as the first window in the window list.

DESCRIPTION

The LMSetWindowList function sets the value of the low-memory global WindowList , which the Window Manager interprets as a pointer to the first window in the window list.

SEE ALSO

To get the pointer used by the Window Manager to identify the first window in the window list, use the LMGetWindowList function (LMGetWindowList) .

LMGetWindowList

Returns the pointer used by the Window Manager to identify the first window in the window list.

pascal WindowPtr LMGetWindowList (void);

DESCRIPTION

The LMGetWindowList function returns the value of the low-memory global WindowList , which the Window Manager interprets as a pointer to the first window in the window list.

SEE ALSO

To set the pointer used by the Window Manager to identify the first window in the window list, use the LMSetWindowList function (LMSetWindowList) .


© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next